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Ablage von Pro jektinf ormationen in XML 

Die Ablage von Pro j ektdaten einer Automatisierungskomponente 
erfolgt in XML . Dabei werden die Daten entweder direkt in 
diesem Format abgelegt oder entsprechende Export/Import Funk- 
tionen bereitgestellt urn Pro j ektdaten nach aufien im XML For- 
mat bereitzustellen . 

Durch dieses Vorgehen werden sind die Pro j ektdaten aufierhalb 
des Projekts in einem standardisierten Datenformat verfiigbar. 
Auf dieser Basis konnen externe Werkzeuge fur die vollstandi- 
ge oder teilweise weitere Verwertung oder Erzeugung von Pro- 
j ektdaten eingebunden werden. 

Beispiele fur solche externe Werkzeuge sind: 

Versionsverwaltungstools wie ClearCase oder PVCS 

Externe CAD-Programme 

Externe Kurvenscheibenwerkzeuge 

Externe Productivity Tools die Teile von Projektdaten ge- 
nerieren konnen 

Externe Skripting Mechanismen urn die Erzeugung oder Dupli- 
zierung von Projektdaten zu unterstiatzen 

Durch die Nutzung des Standardf ormats konnen kommerzielle 
Werkzeuge, die auf XML abbilden, genutzt werden. 
Dartiberhinaus konnen extern erzeugte auf XML basierenden Da- 
ten wie z.B. Maschinenbilder in das Projekt importiert wer- 
den • 

Auf Basis der genannten Mechanismen konnen z.B. Anderungen 
von Projekten durch Vergleich der Projektdaten im XML-Format 
sehr einfach erkannt und Unterschiede f einstgranular aufbe- 
reitet werden. Dies ist insbesondere fur FDA und dem hiermit 
notwendigen Change Control wichtig. 
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XSLT Standard (http://www.w3.org) 



Visualisierung 
(HTML) 



Dokumentation 
(FrameMaker ) 



Kontrolle 
(FDA) 
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Einleitung 

Der Entwicklungsname von SIMOTION war UMC (Universal Motion 
Control) . Es stellt ein Basisautomatisierungssystem dar. Mit 
5 dieser Software ist es moglich durchgangige Automatisierungs- 
systeme fur Produktionsmaschinen zu erstellen (z.B. fur Ver- 
packungsmaschinen, Textilmaschinen, Pressen oder Kunststoff- 
maschinen) . Die Anforderungen fur die SIMOTION- Software ba- 
sieren auf Erfahrungen mit anderen SIEMENS A&D - Produkten 

10 wie zum Beispiel SINUMERIK. Diese und andere Produkte des Be- 
reiches A&D erfullen schon heute die Anforderungen an das Au- 
( ^ tomatisierungssystem. Aber die Gesamtlosung ist unzureichend 
und oft nicht wettbewerbsf ahig, was sich mit der SIMOTION- 
Software andern soil. Deswegen ist die Zielsetzung des 

15 SIMOTION, eine optimale Systemplatt f orm fur Automatisierungs- 
losungen zu bieten. AuBerdem soil SIMOTION die Moglichkeit 
bieten, Maschinenablauf e (SPS), spezifische Technologief unk- 
tionen und vor allem Motion Control - Funktionen zu program- 
mieren. 

20 

SIMOTION ist prinzipiell aus zwei Teilen aufgebaut. 

Das Runtimesystem von SIMOTION, das zu Entwicklungszeiten 
UMC- RT hieJi, ist auf drei verschiedenen Zielsystemen lauffa- 
(b(5 hig: 

- Drive-based, 

- SPS-based und 

- PC-based. 

Es beinhaltet grundsat zlich ein Betriebssystem, Schnittstel- 
30 len zum Antrieb, Basisf unktionen ( wie Lageregler, Interpola- 
tor, Positionieren, Ref erenzieren, SPS-Funktionalitat ) und 
auJSerdem Treiber fur den Feldbus PROFIBUS DP. Die Kommunika- 
tion des Gesamtsystems ist iiber eine Standardkommunikation 
mit SIMATIC, PC und OVA gewahrleistet . 
35 Technologiefunktionen konnen mit Hilfe von Firmwarekomponen- 
ten hinzugeladen werden. Das Konf igurieren dieser Funktiona- 
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litat wird auf einem Erstellsystem vorgenommen und durch ei- 
nen Ladevorgang in das Zielsystem iibertragen. 

Das SIMOTION SCOUT hiefi wahrend der Entwicklung UMC- ES, was 
Erstell- bzw. Engineeringsystem bedeutete. 

Es kann als eigenstandiges System oder als System, das auf 
Step7 aufsetzt, genutzt werden. 

Das SIMOTION SCOUT enthalt eine Vielzahl von Funktionalitat : 

• Es ist moglich ein System oder eine Komponente zu konfigu- 
rieren, zu programmieren und zu pro j ektieren . 

• Programmiertools fur das Runtimesystem sind im SIMOTION 
SCOUT enthalten. 

• Der Test und die Inbetriebnahme, sowie die Diagnose- und 
der Service kann durch die Software unterstutzt werden. 

• SIMOTION SCOUT ist mit einer Bibliotheksf unktion fur Pro- 
gramme, Konf iguration (HW-, SW-Konf iguration) und Maschi- 
nen ausgestattet . 

• SIMOTION SCOUT kommuniziert mit dem Basis ES, das die Da- 
tenhaltung steuert und fur den Zugriff auf die Daten zu- 
standig ist . 

• Auiierdem gibt es die Moglichkeit des Teleservice, der 
Ferndiagnose und der Obj ektverwaltung. 
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Basis ES 
Dateohaltung 




Abbildung 0. 1 : Das Universal Motion Control System 



Die SIMOTION- Software ist nach dem Three-Tier-Konzept aufge 
baut. Sie besitzt also eine grafische Oberflache, eine Verar 
beitungsschicht und eine Datenschicht . 
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Grundlagen 

Dieses Kapitel soil einen Einblick in die Grundlagen der 
5 Software geben. Aufierdem soli es alle im Export- Import- Me- 
chanismus verwendeten Begriffe und Techniken vermitteln . Es 
stellt aber keine vollstandige Dokumentation dar, deswegen 
verweise ich an geeigneter Stelle auf Ref erenzdokumente . 

1 0 (a) Was ist ein Snap- In? 
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20 
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Allgemein versteht man unter einem Snap- In bei SIMOTION ein 
COM- Objekt. Die Workbench kann den Server in Form einer Dll 
laden und somit uber die Schni ttstellen des Servers auf Funk- 
tionen des Snap- Ins zugreifen. Die Kommunikation geht von 
einem Snap- In Host in der Workbench aus . 

Neue Snap- Ins werden mit der Workbench installiert, konnen 
aber auch spater hinzugefugt werden. Ebenso konnen Snap- Ins 
wieder entfernt werden. Wenn ein neues Snap- In hinzugefugt 
wird, legt es einen Registry- Eintrag an. Beim Starten der 
Workbench wird die Registry durchsucht. Neue Snap- Ins in- 
stalliert die Workbench automatisch. Durch diesen Aufbau ist 
es moglich durch neue Snap- Ins dynamisch Funktionalitat zu 
dem SIMOTION SCOUT hinzuzuf ligen und gegebenenf alls zu entfer- 
nen. Snap- Ins werden jedoch nicht sofort beim Start der 
Workbench geladen. Dies geschieht erst wenn eine Benutzterak- 
tion ein Snap- In anspricht. Das Benutzterkommando wird von 
der Workbench an das entsprechende Snap- In weitergeleitet . 



Benutzeraktion 



UMC- Workbench 




UMC- Workbench 
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Beim Laden eines Snap- Ins kann die Oberflache sowie die Me- 
nustruktur von SIMOTION SCOUT geandert werden. Es ist mog- 
lich, dass Toolbars eingefugt werden und verschiedene Pro- 
5 jektteile eine neue Darstellung erhalten. 

Ein Snap- In mufi bei SIMOTION bestimmten Anf orderungen genu- 
gen : 

- Da es ein COM- Objekt im herkommlichen Sinne ist, mufi die 
IUnknown- Schnittstelle implementiert sein, wie COM es 

0 vorschreibt . 

- Fur die Kommunikation zwischen der Workbench und dem Snap- 
In mufl die Schnittstelle IUMCSnapIn vorhanden sein. 

- AuBerdem mussen alle Snap- Ins unter der Kategorie „Snap- 
In of UMC-Workbench" in der Registry eingetragen sein. 

5 Wenn diese Anf orderungen erfiillt sind, konnen noch optional 
neue Schnittstellen hinzugefugt werden. Diese Schnittstellen 
eignen sich, urn spezielle Aufgaben zu ubernehmen wie zum Bei- 
spiel Dateiverwaltung, Kommunikation mit anderen Snap- Ins 
oder grafische Schnittstellen. 
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IUnknown 




IUMCSnapIn 



optionales Interface {j^- 



¥ 



Abbildung 0.2. : Schnittstellen eines Snap- Ins 



(b) Anforderungen und Vorteite des Export- Import- Tools 



10 



Durch die Export- Import- Software soil es ermoglicht werden, 
dass die Daten eines SIMOTION- Projektes aus dem Basis ES in 
ein lesbares ASCII- Format exportiert werden konnen. Mit Hil- 
fe dieser exportierter Daten soli durch die Import- Funktion 
ein lauffahiges Projekt erzeugt werden konnen. 



15 



20 



Die exportierten Daten werden im XML- Format gespeichert. Da- 
bei wird unter den Teilkomponenten eines Projektes unter- 
schieden, indem sie in verschiedenen XML- Dateien beschrieben 
werden. Die bei dem Export entstandenen Dateien liegen in ei- 
ner Verzeichnisstruktur vor, die an den Aufbau des SIMOTION- 
Projektes angelehnt ist. An die Export- Import- Software des 
SIMOTION SCOUT werden folgende Anforderungen gestellt: 

- Die entstandenen Dateien sollen die Projektdaten mit Hilfe 
einer XSL- Datei in einer geordneten, tabellarischen Form 
im Internet- Explorer 5 anzeigen. 

- Exportierte XML- Dateien sollen bei der Diagnose eines 
Projektes hilfreich sein. Dies wird durch die Navigation 
liber das Projekt im Internet- Explorer erreicht. 
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- Weiterhin sollen durch einen modularen Aufbau des expor- 
tierten Projektes einzelne Teilkomponenten eines Projektes 
komfortabel ausgetauscht und unabhangig von der Version 
der SIMOTION- Software in andere Projekte eingefiigt werden 
konnen . 

- Durch einen strukturierten Aufbau der Dateien im Verzeich- 
nisbaum, soil die Archivierung und Erstellung von Versio- 
nen eines SIMOTION- Projektes vereinfacht werden. 

- Aufierdem kann man Dateien liber das Internet, per Email o- 
der liber FAX an dritte weiter zu geben. 

- Es ist prinzipiell moglich, dass der Benutzter mit Hilfe 
eines ASCII- Editor Daten des Projektes andern kann und 
diese durch den Import in das Projekt iibernehmen kann. Wo- 
bei die Anderung von Projektdaten normalerweise im Projekt 
in der Workbench vorgenommen werden sollte. 

(c) Einordnung des Exports und des Imports in die SIMOTION- Software 

Das in der Einleitung genannte Three-Tier-Konzept kommt auch 
in der Import- Export- Software zur Anwendung . 
Die grafische Benut zteroberf lache wird in der Workbench tiber 
ein Snap- In angeboten. 

Die gesamte Verarbeitung des Ex- oder Imports wird durch den 
XML- Server realisiert. Er kann uber Schnittstellen auf die 
Daten des Basis ES lesend Oder schreibend zugreifen. Uber ei- 
nen sogenannten Connection-Point werden die Ausgaben bei dem 
Export oder Import an das Snap- In in der Workbench gegeben. 
Die Daten werden mit Hilfe eines XML- Parser ubersetzt. Bei 
dem Export ist die Datenschicht das Basis ES, aus dem die Da- 
ten der XML- Files gewonnen werden. Bei dem Import ist dies 
umgekehrt. Die XML- Dateien werden ausgelesen und die Daten 
in das Basis ES geschrieben. 
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Workbench 



1 Siiap 


-In 







Connection- Point 



Interfaces des XML- Servers 
zur Kommunikation mit dem 
Snap- In in der Workbench 




Abbildung 0.3.: Kommunikation des Export- Import- Tools 



(d) Das XML- Format 



10 



XML (extensible Markup Language) ist eine Metasprache fiir das 
Definieren von Dokumenttypen . Es ist damit moglich, Dokumente 
zu erstellen, die alle den gleichen GruncLmustern im Aufbau 
folgen. Auf der Grundlage dieser Dokumente konnen Programme 
leichter arbeiten . 
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Andere Vorteile von XML sind, dass die Daten strukturiert und 
hierarchisch beschrieben werden konnen. Aufierdem ist die 
Sprache Plattform unabhangig und einfach von Mensch und Ma- 
schine zu erzeugen. Ein entscheidender Aspekt fiir die Verwen- 
dung von XML ist, dass eine strickte Trennung zwischen In- 
halt, Darstellung und Struktur vorgenommen wird. 
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XML 




XSL-Datd 
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Abbildung 0.4. : Aiifbau und Gliedenmg von XML 

(e) Unterschiede zwischen XML und HTML 

Warum die meisten Anbieter, Programmierer und Anwender von 
HTML auf XML umsteigen ist sehr einfach zu erklaren. Wahrend 
HTML eine Auszeichnungssprache ist, ist es mit XML moglich 
eine Auszeichnungssprache zu definieren. 

Vorteilhaft ist auch das Definieren eigener Tags, XML- Files 
konnen ganz bestimmte Tags enthalten und diese konnen wieder- 
um Tags enthalten. Dadurch kann ein XML- File einen Baum auf- 
bauen, der zu einer strukturierten Trennung verschiedener In- 
halte fuhrt. Damit ist die Grundlage fur eine maschinelle Be- 
arbeitung des Dokumentes gewahrleistet , die mit einem HTML- 
Dokument leider nicht gegeben ist. Ein groiier Unterschied 
zwischen HTML und XML ist die Trennung von Inhalt, Darstel- 
lung und Struktur. Nachteilig erscheint manchen Programmie- 
rer, dass er bei HTML sehr frei in seiner Formulierung ist, 
wahrend er bei XML auf die Wohlgef ormtheit eines Dokumentes 
achten muB (siehe Kapitel (f)). 

(f) Gultigkeit, Wohlgeformtheit, validierende und nicht-validierende Parser 



Bei der Verarbeitung von XML- Dokumenten, wird zwischen zwei 
Instanzen unterschieden : dem XML- Parser und der Anwendung. 
25 Der Parser verrichtet seine Arbeit im Sinne einer Anwendung 
und ist in den meisten Fallen ein Browser. Es kann mit zwei 
verschiedenen Parsern gearbeitet werden, mit dem DOM- oder 
dem SAX- Parser. Der DOM- Parser erstellt einen XML- Baum und 
der SAX- Parser ist ereignisorientiert . Diese beiden Parser 
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werden im Kapitel 0 naher erklart. Alle Parser sollten jedoch 
diese Eigenschaf ten erfullen: 

- Ein Parser priift ein XML- Dokument auf Wohlgef ormtheit und 
gibt gegebenenf alls Fehler aus. 

5 - Wenn das Dokument aus mehreren Bestandteilen aufgebaut 
ist, werden diese zusammen gefiigt. 

- Auflerdem wird ein Baum erstellt, durch den die Anwendung 
auf die Inhalte der Tags zugreifen kann. 

10 Wenn ein Dokument auf Gultigkeit untersucht wird, vergleicht 
der Parser das Dokument mit der DTD. Da dieser Vergleich sehr 
umfangreich ist, wurde das Konzept der Wohlgef ormtheit einge- 
fiihrt. Bei diesem Konzept wird lediglich sichergestellt , dass 
die Erstellung des Baumes moglich ist. 

15 

Grundsatzlich ist ein Dokument wohlgeformt, wenn es folgende 
sechs Eigenschaf ten besitzt: 

1. Jedes XML- Dokument mufi mit einer Deklaration beginnen. 
Wie zum Beispiel: <?XML version = *1.0* ?>. 
20 2. Alle Elemente miissen ein Ende- Tag besitzen: 

<title> Der Export - Import - Mechanismus des SIMOTION 
SCOUT </title> 

Ebenso miissen leere Elemente wie <BR> ein Ende- Tag besit- 
zen : 

: J|5 Entweder <BR/> oder <BR> </BR>. 

3. Alle Elemente sind case-sensitive, das heili zwischen 
Grofi- und Kleinschreibung wird unterschieden . 

4. Alle Attributwerte sind in Hochkommas zu setzen. 

5. Ein sauberes Verschachteln der Tags ineinander mufi gewahr- 
30 leistet sein. Das heiflt untergeordnete Tags miissen ge- 

schlossen werden bevor iibergeordnete Tags geschlossen wer- 
den . 

6. Ein Element mufi als eine Art Container alle anderen Ele- 
mente einbetten . 

35 
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Da bei der Prufung auf Wohlgef ormtheit kein Abgleich mit der 
DTD statt findet, ist ein wohlgef ormtes XML- Dokument nicht 
unbedingt gultig. 
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Abbildung 0.5.: Unterscheidung Wohlgeformtheit und GOltigkeit eines XML- Dokuments 



Aus diesen Griinden kommen zwei verschiedene Parser zur Anwen- 
5 dung. Ein validierender Parser pruft auf Gultigkeit, ein 
nicht validierender Parser prtift auf Wohlgeformtheit eines 
XML- Dokuments. Wenn auf die Gultigkeit eines Dokumentes ge- 
pruft wird, ist die Prufung auf Wohlgeformtheit eingeschlos- 
sen . 

00 (g) Die Stylesheets (XSL) 

XSL (extensible Stylesheet Language) ist eine Beschreibungs- 
sprache der Darstellung eines XML- Dokumentes. Mit Hilfe ver- 
schiedener XSL- Dateien konnen XML- Dokumente andere Darstel- 

15 lungen annehmen. 

Bei HTML wird die Darstellung mit cascading Stylesheet Langu- 
age (CSS) beschrieben. Diese Beschreibungsart kann ebenso in 
XML- Dokumenten eingesetzt werden, jedoch gibt es bei XSL ei- 
nige Vorteile gegenuber CSS. XSL ist eine Programmiersprache 

20 im herkommlichen Sinne, das heiiJt IF- Abfragen und Speiche- 
rung von Werten in Variablen konnen gesetzt werden. Einzelne 
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Komponenten konnen genommen werden und an anderen Platzen 
auftauchen, wie zum Beispiel in der Kopf- Oder Fufizeile. Da 
XSL nicht an die Sprachen der westlichen Welt angepasst ist 
und damit nicht ausschliefilich horizontale Schrif tzeichen 
dargestellt werden konnen, ist es global verwendbar. 
Damit ein XML- Dokument eine XSL- Datei zur Darstellung he- 
ranzieht, muli diese am Anfang des XML- Dokumentes bekannt ge- 
macht werden. 
Zum Beispiel: 

<?xml-stylesheet type=" text/xsl" href="umc . xsl"?> 

(h) Die Struktur einer XML- Seite (DTD) 

In einer DTD (Documenttype- Definition) wird die Struktur und 
die Gliederung eines XML- Dokumentes festgelegt. Alle in ei- 
nem XML- Dokument verwendeten Elemente miissen in der zugeho- 
rigen DTD beschrieben werden. Weiterhin muli in der DTD fest- 
gelegt werden, wie die Elemente verschachtelt sind und welche 
Werte die Attribute annehmen konnen. 

Durch die Festlegung der Regeln fur XML- Dokumente in einer 
DTD, ist es moglich einer Anwendung das Auslesen und die Ver- 
arbeitung der Daten zu uberlassen. 

DTD konnen in einer separaten Datei untergebracht werden (ex- 
terne DTD) . Anderenfalls kann die DTD am Anfang des XML- Do- 
kumentes stehen, wobei sie hier interne DTD genannt wird. 
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Ein Ordner besteht sus mind es tens einem Buch 
< ! ELEMENT ordner (book)-f > 

Der Ordner hat ah Pftchattribut die ID — — 
< ! ATTL I ST ordner id ID #REQUIRED > 

Ein Buch besitzl erneii Titel narideslens einsn Autar und wards durch emen Verlag verfcffentlicht 
<! ELEMENT book 



< ! ATTL I ST book 

Ein Tit el besteht sus einem String 

< ! ELEMENT title 



<! ELEMENT 
< ! ELEMENT 



author 
publisher 



( title, author* „ puplisher ) > 
isbn CDATA #REQUIRED> 
( #PCDATA )> 
(#PCDATA)> 
(#PCDATA)> 



Abbildung 0.6. : Bcispiel ffir cine DTD 
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Das Snap- In in der Workbench 

Das Snap- In des XML- Tools ist ein mittels ATL geschriebener 
COM- Server, der eine Schnittstelle zwischen dem Benutzer und 
dem XML- Server darstellt. Durch bestimmte Benutzeraktionen 
kann das Snap- In geladen werden. Ober die grafische Oberfla- 
che kann der Benutzer den Export und den Import bedienen. Die 
Kommunikation zwischen Snap- In und Workbench wird uber ver- 
schiedene Schnittstellen des Snap- Ins ermoglicht. 

(i) Das GUI des Snap- Ins 

Dieses Kapitel beschreibt die grafische Oberflache, die das 
Snap- In zur Verfugung stellt, und dessen Bedienung zum Ex- 
oder Import von Pro j ektdaten . 

0) Starten des Ex- Oder Imports 

Das Snap- In wird beim Klicken auf den entsprechenden Button 
oder beim Auswahlen des Exports oder Imports im Menu ^Datei^ 
geladen. 
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B©*«trew:n _ Etn^on Znasy^la-n Arcrcfo Extras 




Abbildung 0.1.: Laden des Snap- Ins durch Benutzeraktionen 

(k) Der Export eines Projektes 



Der Export eines Projektes ist natiirlich nur moglich, wenn 
ein Projekt geoffnet ist, Nach dem des Exports wird das Snap- 
In geladen und es erscheint dieser Dialog: 
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Projekt Export 



j~ Expo ?t E jnstel fiihgen ~ — • — . 

j Geben sis Zielpfad und Ziefnamen des Exports an- " \ \ ' \ 



program rn e\Si e m e n s\Ste p 7\S 7 p r o j\Pr oje kt\u 7\>:m I d ata\Pi o i e kl >:rn I 



a ! " 




Abbildung 0.2.: Der Exportdialog 

Der Projektpfad beschreibt das Verzeichnis, in dem die expor- 
tierten Daten gespeichert werden sollen. Man kann im Dialog 
einen Ordner angeben, der das exportierte Projekt beinhalten 
soli. Durch den „0rdner- Button* kann der Ordner aus dem Ver- 
zeichnisbaum ausgewahlt werden. 



Verzeichnis auswahlen 



■41 




Desktop 
B-M Arbeitsplatz 
| & 3VHDiskette(A:) 
[ ijjhm (C:) 

i ■ iM autodbg 
j j \ (MAXNF zz 
\ \ ii} 23 Config 

\ Wr-m MSOffice.97 
j ! (23 mvfslogs 
\ $r(M Programme 
! &-CBJ Adobe 
! lf)~££j Gemeinsame Dateien 
j j $ (23 Internet Explorer 
.....L....J._J_^^^^..y5C|itech 



mm 




10 



Abbildung 0.3. : W&hlen eincs Verzeichnisses fur das zu exportierende Projekt 



Dabei ist zu beachten, dass alle im Ordner vorhandenen Datei- 
en zu Beginn des Exports geloscht werden. Mit dem OK- Button 
wird letztendlich der Export gestartet. 
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(I) Der Import eines Projektes 

Der Import hat zwei Moglichkeiten ein Projekt zu importieren 
Zum Einem konnen die Daten in ein bestehendes Projekt einge- 
5 fugt werden. Dazu mufJ der Import gestartet werden, wenn ein 
Projekt geoffnet ist. Der Benutzer wird vor dem Import ge- 
fragt, ob er das Projekt andern will. Wenn der Import in ein 
bestehendes Projekt durchgeflihrt wird, werden neue Daten ein 
gefugt, Daten, die im zu importierenden Projekt sowie im be- 

10 stehenden Projekt vorkommen, durch die importierten Daten ak 
tualisiert und bestehende Daten beibehalten. 

i Zum Anderen kann beim Import ein neues Projekt angelegt wer- 

. den. In diesem Fall muii der Import gestartet werden, wenn 

kein Projekt geoffnet ist. Das importierte Projekt ist nach 

15 dem Import mit dem exportierten Projekt identisch. 

Der Import blendet einen ahnlichen Dialog auf wie der Export 



.a 
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Projekt Impart 



import Einstellungen- 



' • OrtderXMLFiojeklDnteien:' . , ' .. . : 



C\Progremrne\S i e m e n s\Ste p 7\S 7 p r o j \ 




' I Zielpfad und Ztelname der Projektdatei; , ; 




Abbildung 0.4. : Der Importdialog 



/ Der Zielpfad zeigt auf das neu angelegte Projekt Oder auf das 
5 Projekt, in das importiert werden soil. Hier ist ebenfalls 
der Projektpfad angegeben, in dem das Projekt importiert 
wird. Es sollte in diesem Dialog eine XML- Datei ausgewahlt 
werden, die die Wurzel des zu importierenden Projektes ist. 
Diese XML- Datei kann durch einen File- Dialog ausgewahlt 
10 werden, der durch den „Ordner- Button 1 " angezeigt wird. 
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en sie das enlsprechende XML-File aus: 


BO 


Sue 


ben in 


>23ltest1 >j M 





J aqwesqwe 



Olfnen j 



HlliiP^lllllp^i 8 ^-^ 1 

0atE ^ jXML-Dateienr^D ~~~~3 , Abbrechen 



— ' Abb? e eh en 



Abbildung 0.5.: Wahlen einer XML- Datei fur den Import 

(m)Die Statusausgabe des Ex- bzw. Imports 



15 Der Status des Exports oder des Imports wird jeweils in einem 
Ausgabefenster dokuirtentiert . Dort wird der Benutzer auf Feh- 
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ler, die rot hervorgehoben sind, aufmerksam gemacht, die Be- 
endigung des Exports oder Imports ausgegeben und ein Link zu 
den XML- Dateien anzeigt. 



Seite 



23 von 56 



200023311 



24 



UMC - aqwesqwea 



0 




Der Export der Projektdaten wurde gestartet 
Bitte Worten... 

Einstiegspunktfur dac Betrachten der Oaten im Internet Explorer (Version 5): 

filettPAtesli togwesflweJitml 



Ort der exportierten XML-Doten: 
DAtest1\ 

Der Export der Projektdaten wurde beendet 




Abbildung O.6.: Statu sausgabe des Ex- oder Imports 



10 



Die gesamte Verarbeitung des Ex- oder Imports wird durch den 
XML- Server realisiert. Dies ist ein COM- Server, der das 
Auslesen und Obersetzten der Daten ubernimmt. Bei dem Export 
ist die Datenschicht das Basis ES, aus dem die Daten der XML- 
Files gewonnen werden. Bei dem Import ist dies umgekehrt. Die 
XML- Dateien werden ausgelesen und die Daten ins Basis ES ge- 
schrieben . 



(n) Die Interfaces des Snap- Ins 



Die Schnittstellen eines Snap- Ins ermoglichen die Koramunika- 
15 tion zwischen der Workbench und dem Server des Snap- Ins. Ein 
Snap- In muft die Schnittstelle IUMCSnapIn implementieren, urn 
als Snap- In erkannt zu werden. Die Schnittstellen IUMCHelp 
und IUMCSnapInProperties beinhalten verschiedene Funktionen, 
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die ein Snap- In verwenden kann. Naturlich konnen andere 
Snap- Ins diese Schnittstellen implementieren . Deswegen gehe 
ich auf diese Schnittstellen nur kurz ein und schenke der 
speziellen Schni ttstelle des XML- Servers {IXMLStatus) mehr 
Aufmerksamkeit . 
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IUnkn 


own fej 




IUMCSnapIh 
lUMCHelp 




111 


DCMLStatus 

IUMCSn^InProperties 
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11 







Abbildung 0.7. : Schnittstellen des XML- Snap- Ins 

(o) lUMCSnapIn 

Die Schnittstelle lUMCSnapIn ist die obligatorische Schnitt- 
stelle fur Snap- Ins wie die IUnknown Schnittstelle von COM. 
Jedes Snap- In muli diese Schnittstelle implementieren wobei 
es unerheblich ist, ob das Snap- In eine grafische Oberflache 
besitzt oder nicht. Weiterf uhrendes Dokument zu diesem Inter- 
face ist unter 

Werlf 452a\umc all$\doc\Icd\ICD SnapInMCD Snapln SnapInHost. 
doc zu finden. 

(p) lUMCHelp 

Urn eine Hilfe zu einem Snap- In zu erhalten, ist es moglich 
mit Fl eine Hilfedatei zu offnen. Diese Funktionalitat wird 
durch das Interface lUMCHelp zur Verfugung gestellt. Zu die- 
ser Schnittstelle ist eine Dokument at ion unter 
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Werlf 452a\umc all$\Systemtest\Engineering SystemMnf os\Kochb 
uch ES\Kochbuch ES.doc vorhanden. 

(q) lUMCSnaplnProperties 

5 Dieses Interface ubermittelt der Workbench die Eigenschaf ten 
des Snap- Ins. Das ist notig, da die Workbench sehr allgemein 
gehalten ist und keine spezifischen Daten des Snap- Ins 
kennt. Wenn ein Snap- In diese Schnittstelle implementiert , 
kann eine bestimmte Darstellung erreicht werden. Aufierdem 
10 konnen Anderungen wahrend der Laufzeit der Workbench ubermit- 
telt werden. Die Schnittstelle lUMCSnaplnProperties ist in 
%v dem Designdokument 

Werlf 452a\umc all$\doc\Icd\ ICD SnapInMCD Snapln Properties, 
doc naher beschrieben. 

15 (r) IXMLStatus 

Diese Schnittstelle ermoglicht das Konvertieren eines Devi- 
ces, wobei der Typ des Devices verandert wird. Die Konvertie- 
rung erfolgt durch das Exportieren der Devicedaten und an- 
schlieiiendes Importieren der Devicedaten. Damit hat diese 
Schnittstelle mit dem eigentlichen Export und Import eines 
Projektes nichts zu tun, verwendet aber einen ahnlichen Me- 
chanismus, urn ein Device zu konvertieren. 

Die Schnittstelle besitzt zwei Funktionen: ExportAndConvertE- 
SObject und ImportESObject . ExportAndConvertESObj ect expor- 
tiert und konvertiert, wie der Name schon sagt, ein Device. 
Dieser Methode mufi eine DevicelD, eine TypelD und ein Ziel- 
verzeichnis tibergeben werden. Wenn das Device exportiert 
wird, 
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wird die alte TypelD durch die ubergebene ersetzt. Alle Dia- 
loge und Benut zeraktionen werden vernachlassigt , da der Ex- 
port nur intern im Programm durchgefuhrt wird. Den eigentli- 
chen Export eines Devices ubernimmt der XML- Server, auf den 
ich im Kapitel 0 naher eingehen werde. Da in diesem Fall nur 
ein Teil des Projektes exportiert werden soli, wird eine Mas- 
ke gesetzt, die das spezif iziert • Die Funktion ExportAndCon- 
vertESObject liefert nach erf olgreichem Export ein String des 
XML- Dateinamens zuriick . 

Die Methode ImportESObj ect importiert das Device und erhalt 
den Ordner, der die exportierten Dateien enthalt, und die 
XML- Datei, die bei Export AndConvertESObj ect zurlickgelief ert 
wurde. Bei dem Import ist es ebenso nicht notwendig die Dia- 
loge anzuzeigen, da es sich wie beim Export um einen internen 
Import handelt. Nun importiert der XML- Server das Device auf 
Grund der iibergebenen XML- Datei und gibt die DevicelD an die 
auf ruf ende Funktion zuriick . 
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Der XML- Server 

Der XML- Server ist ein ATL- Server und ftihrt den eigentli- 
chen Ex- oder Import der Daten durch . In diesem Kapitel werde 
ich auf die Funktionsweise und den Aufbau des Servers einge- 
hen . 

Die Dll wird in das Prograimn geladen, wenn die Schnittstelle 
des Servers angesprochen wird. Die Schnittstelle heifit IXML- 
Server und bieten zwei Methoden an. Mittels dieser Methoden 
wird der Import und der Export angestofien, deswegen heifien 
sie Startlmport und StartExport . Diese Funktionen sind die 
einzigen Funktionen, die von AulJen aufgerufen werden konnen, 
denn wie aus dem Bild ersichtlich stehen keine weiteren 
Schnittstellen zur Verfiigung. 





IUnknown 














1 


IXMLServer C/? 


















} 


p 



Abbildung 0. 1.: Schnittstellen des XMLServers 



(s) Der Export 

(t) Der DOM-Parser 

Der Export arbeitet mit dem Xerces Parser von Apache. Dieser 
Parser ist ein DOM- Parser, der sich dadurch auszeichnet, 
dass er einen XML- Baum aufbauen kann. Die Funktionalitat des 
Parsers wird in verschiedenen Headerdateien beschreiben. 
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Durch das Einfugen dieser Dateien im Projekt stehen die Funk- 
tionen des DOM- Parsers zur Verfiigung. 

Die Klassen DOM__Node , DOM__Document und DOM_Element sind die 
wichtigsten Klassen des DOM- Parsers. Ein XML- File wird 
durch die Klasse DOM_Document reprasentiert . Ein Tag oder E- 
lement eines XML- Files wird durch ein DOM__Element reali- 
siert, die in einem DOM_Document eingefugt werden konnen. Au- 
Berdem wird durch die Klassen DOM_Attr , DOM_Entity, DOM__ Tex t 
und DOM__Comment weitere Funktionalitat zur Verfiigung ge- 
stellt, urn einen Baum aufzubauen und ein XML- File zu erstel- 
len. Fortfuhrende Dokumentation zu dem DOM- Parser von Apache 
ist im Internet unter www.apache.de und 

www.w3.org/TR/19 98/REC-DOM-Level-l-19981001/level-one- 
core.html zu finden. 

Der Aufbau des XML- Baumes wird durch den Aufruf verschiede- 
ner Funktionen des DOM- Parsers erreicht. Deswegen beinhaltet 
die Klasse CDomHelper die Grundf unktionalitat , urn die XML- 
Files zu erstellen. 

Ein wichtiger Member der Klasse ist die Instanz der Klasse 
DOM_Document, die eine XML- Datei erzeugt, und eine Instanz 
der Klasse DOM_Element, die das Roottag speichert. 
Wie aus dem Code ersichtlich, sind verschiedene Funktionen 
zum Beschreiben eines XML- Files vorhanden, wie writeDomDoc, 
writeDTD und writeXSL. Sie sind private Funktionen der Basis- 
klasse CDomHelper und werden am Ende des Exports einer Daten- 
menge aufgerufen. Somit wird eine XML- Datei erst nach dem 
vollstandigen Export geschrieben, urn keine inkonsistenten Da- 
ten in der Datei zu erhalten und damit die Fehlerbehandlung 
erleichtert wird. Das heiiit, wenn ein Fehler beim Exportieren 
von Daten auftritt, konnen die fehlerhaften Daten verworfen 
werden, ohne das eine Datei von der Festplatte geloscht wer- 
den mufi . 

Aufierdem ist es moglich mit den Funktionen openDomHelper und 
closeDomHelper Vorinitialisierungen bzw. das abschliefiende 
Schreiben der XML- Datei durchzuf iihren . Die Funktion openDom- 
Helper initialisiert die Membervariablen mit gultigen Werten 
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und legt ein DOM_Document mit einem DOM_Element an, das den 
Namen des ubergebenen Strings besitzt. In der Methode close- 
DomHelper werden die oben genannten Funktionen zum Schreiben 
des XML- Files aufgerufen. 
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Um XLinks zu erstellen und neue Verzeichnisse anzulegen, ste- 
hen die Funktionen createSubDir, setXLink und setFullXLink 
zur Verfugung. 

Die Funktionen writeDTD und ManageNavigation sind reine vir- 
tuelle Funktionen und mussen von alien Klassen, die von der 
Klasse CDomHelper abgeleitet sind, implementiert werden. 



class CDomHelper 
{ 

public : 

CDomHelper ( ) ; 

virtual -CDomHelper () ; 



DOM_Document *getDomDoc() 
DOM_Element *getDomRootNode ( ) 

of stream *getOS ( ) 



{ return &m_domDoc; } ; 

{ return &m_domRootElement ; } ; 

{ return &m_OS; } ; 



/////////////////////////// 
// Static Members 
static CExport *m_pExport; 
static bool m bSwitchXSL; 



protected: 

of stream 
of stream 
DOM_Document 
DOM_Element 
bool 



m_OS ; 
m_XSL_OS; 
m_domDoc; 
m_domRootEl ement ; 
m DTD Check; 



virtual void writeDTD( ) = 0; 

virtual void writeXSLO; 

virtual HRESULT ManageNavigation ( ) = 0; 



Quell code 0.1.: Klassendefinition der Klasse CDomHelper 
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Wenn man nun bestimmte Daten eines Projektes exportieren 
mochte, wird eine eigene Klasse von der Klasse CDomHelper so- 
wie von der Klasse CBasisEsHelper abgeleitet. Die Klasse CBa- 
sisEsHelper ist wichtig, um an den Pointer auf die entspre- 
5 chende Schnittstelle im Basis ES leichter zu gelangen, und 
wird im Kapitel (q) eingehend beschrieben. 

Bei dem Export eines Projektes werden zwei verschiedene Arten 
von XML- Dateien erstellt. Es konnen Dateien als „Linkdatei- 
en* fungieren sowie als „Datendateien* . Die „Linkdateien* 
10 beinhalten keinerlei Daten, sondern nur Links zu „Datendatei- 
en* und „Linkdateien* , die in einem Unterverzeichnis liegen 
(siehe Kapitel 0) . 

P 

Um eine „Datendatei* zu erstellen, wird die von den beiden 
15 oben genannten Klassen abgeleitete Klasse benotigt, die ein 

neues XML- Dokument anlegt und dies mit den zu exportierenden 
Daten fullt. Diese Daten sollten moglichst eine abgeschlosse- 
ne Datenmenge bilden. 

Diese Klasse muli die Funktion ManageNavigation, wie in den 
20 folgenden Abschnitten erlautert, iiberschreiben . 
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Die Funktion ManageNavigation ist der Einstieg in die Klasse. 
Hier soli dafur gesorgt werden, dass ein XML- Dokument ange- 
legt wird, die Daten exportiert werden und das XML- File mit 
5 den exportierten Daten beschrieben wird. 

Das Anlegen der XML- Datei wird, wie oben beschrieben, durch 
die Funktion openDomHelper angestofien. Danach ist die Member- 
variable m^domRootElement auf einen gultigen Wert gesetzt, an 
die man nun weitere Elemente anfugen und somit den XML- Baum 
10 aufbauen kann. 

Fur das Exportieren einzelner Daten ist es moglich, eigene 
Funktionen zu erstellen und diese dann in der Methode Manage- 
Navigation aufzurufen. Dabei kann man die Daten zum Einen di- 
rekt an das Rootelement, das wie gesagt in der Variable 
15 m_domRoot Element gespeichert ist, anhangen oder sie anderen 

Falls unter ein neu erstelltes Element hangen, je nach Struk- 
tur der Daten im Basis ES. Das heifit, das die Funktionen den 
ubergeordneten Knoten als Auf ruf sparameter erhalten und sie 
sich ebenso tief wie die Elemente im XLM- Baum schachteln 
20 konnen. 

Wenn alle Daten aus dem Basis ES gelesen wurden und keine 
Fehler auftraten, wird die Funktion closeDomHelper aufgerufen 
und somit die XML- Datei mit den Daten gefullt. 

Eine „Linkdatei* wird durch eine prinzipiell genauso aufge- 
baute Klasse erstellt. Die Funktion ManageNavigation ruft die 
Methoden openDomHelper und closeDomHelper auf, urn die XML- 
Datei zu erstellen. Pro Link kann man eine Funktion anlegen, 
die in der Methode ManageNavigation aufgerufen wird. Diese 
30 Funktionen sollte einen XLink zu der entsprechenden Datei an- 
legen, eine Instanz der Klasse anlegen, die den Export der 
Daten durchfuhrt, und deren ManageNavigation Funktion aufru- 
f en . 

35 Die DTD eines XML- Files wird mit der Funktion writeDTD er- 
stellt, die wie schon erwahnt uberschrieben werden muft . Fur 
die DTD wird am Beginn des XML- Files ein String eingefugt, 
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in dem ein Makro an die dafur vorgesehene Membervariable an- 
gehangt wird. Dafiir stehen die Dateien DTDHelper.h und DTDOb- 
jectDefs.h zur Verfugung. In der Datei DTDHelper.h sind ver- 
schiedene Makros definiert, die das Erstellen einer DTD ver- 
einfachen sollen. In der DTDObj ectDefs . h mufi nur noch ein 
spezielles Makro fur den DTD- String definiert werden, das 
dann in der Methode writeDTD verwendet wird. 
Die XSL- Definitionen werden ahnlich erstellt und sind fur 
die Daten wichtig, die in Internet- Explorer angezeigt werden 
sollen. Auch hier existieren zwei Haederdateien XSLDefs .h und 
XSLDefsHelper.h, die Strings fur die XSL- Files definieren. 
In der XSLDefsHelper . h sind Makros definiert, die das Erstel- 
len der XSL- Datei erleichtern. Die Makros fur die jeweilige 
XML- Datei werden in der XSLDefs .h Datei eingefiigt. Es mufi 
darauf geachtet werden, dass die neue XSL- Definition an ent- 
sprechender Stelle in eine andere eingefiigt wird, wenn fur 
die XML- Datei kein eigener Ordner angelegt wird und sie sich 
mit anderen XML- Files eine XSL- Datei teilen mufl . Eine eige- 
ne XSL- Datei wird nur von den Klassen, die eine „Linkdatei* 
erstellen, durch die Funktion writeXSL angelegt. 

(u) Navigation uber ein Projekt 

Fur die Beschaffung der Pointer auf die Schnittstelle, die 
fur den Export angesprochen werden mufi, stehen den Klassen 
der Export- Import- Software die Klasse CBasisEsHelper zur 
Verfugung. 
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class CBasisEsHelper 
{ 

public : 

// Konstruct / Destruct 
CBasisEsHelper { ) ; 
virtual -CBasisEsHelper () ; 

//static Basemembers 
public : 

static CComPtr<IMC_Project> m_pProject; 

static CComPtr<IMC_Device> m_pDevice; 

static CComPtr<IMC_Ident> m_pTO; 

static CComPtr<IMC_Program> m_pProgram; 

static CXMLServer* m_pXMLServer; 

static CComPtr<IUMCWBObjectSetHandler> m_pObj ectSetHandler ; 

static long m_!Obj ectSetHandl e; // Handle auf das Objectset 

static CComPtr<IUMCSnapInHost> m_pSIH; 
static CComPtr<IUMCSnapIn> m_pSI; 

static UMC_PROJECTMODE m_Proj ectMode; 

static std: : map<_bstr_t , _bstr_t> m_bstrChangedDeviceNameList; 
static IsNameMapEntry*m_pTOMap; 

static long m_nTOMapSize; 

static unsigned long m_Export Filter; 

Quellcode 0.2. : Klasscndefinition der Klasse CBasisEsHelper 
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Diese Klasse besitzt einige Variablen, die auf wichtige 
Schnittstellen zeigen. Von ihnen aus konnen andere Interfaces 
angesprochen werden. Daruber sind die benotigten Schnittstel- 
len zu finden. Die wichtigsten Interf acepointer sind zu den 
Schnittstellen IMC_Project, IMC_Device, IMC_Ident und 
IMC_Program. Aufierdem gibt es noch Pointer zum Snap- In, zum 
Snap- In- Host und zum XMLServer fur die Ausgaben beim Im- 
und Export. Um die Daten bearbeiten zu konnen, mussen sie an 
ein sogenanntes „Ob j ectSet* der Schnittstelle IUMCWBObj ect- 
SetHandler gebunden werden. Auf dieses Interface zeigt die 
Memb e r va r i ab 1 e m_pObj ectSe tHa ndler. 
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Neben den Variablen sind verschiedene Funktionen definiert. 
Daten, die in ein XML- File geschrieben werden, mussen in 
Strings vorliegen. Deswegen sind in der Klasse CBasisEsHelper 
mehrere Methoden zum Konvertieren von Daten in Strings und 
umgekehrt vorhanden. Fur das „ObjectSet* sind verschiedene 
Funktionen definiert, die Objekte dem „ObjectSet* hinzufiigen 
und entfernen konnen. 



10 



15 



Die Daten eines Projektes sind unter verschiedenen Schnitt- 
stellen abgelegt. Urn an ein Interface zu gelangen, das die 
gewiinschten Daten enthalt, ist es manchmal notwendig tiber 
verschiedene andere Schnittstellen zu navigieren. Fur das im 
Kapitel (c) beschriebene Beispiel, war es notig liber zwei 
weitere Schnittstellen das Interface anzufordern. Wie aus der 
Abbildung 0.2 ersichtlich, ist es moglich die Schnittstellen 
durch Aufrufen von Querylnterface und getObj ectBylD zu erhal- 
ten . 



o 



Querylnterface 



IMC_Pro j ect 



ge t Obj e c t By ID 



Qu eryln t erf a ce 



IMC Ident 



IMC_Project 
Navigate 



IMC_Alarms_ 
S_Navigate 



20 



Abbildung 0.2.: Navigieren zu den Interface fDr den Export der Alarme 



Eine Dokumentation uber die Schnittstellen des Basis ES und 
eine Beschreibung, wie verschiedene Interfaces angesprochen 
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werden, ist unter 

Werlf 452a\umc all$\doc\ICD\icd basis es.doc vorhanden. 
(v) Ein Beispiel fur den Export - exportieren von Alarmen 

5 Urn die Funktionsweise und den Aufbau des Exports verstandli- 
cher zu machen, erlautere ich den Export am Beispiel des Ex- 
ports von Alarmdaten. 

Die Stelle, an der das Programm erweitert werden mufi, ist ab- 
hangig von den Daten, die exportiert werden sollen, da der 
10 Export die Dateien in einer Verzeichnishierarchie ablegt, die 
der Hierarchie des Projektes im SIMOTION SCOUT- Programm ahn- 
\& lich ist (siehe Kapitel 0) . Die Alarme sind pro j ektglobal , 
deswegen sind sie auf der ersten Ebene zu exportieren. 

15 Da die Alarme nicht von anderen Daten im Projekt abhangig 
sind, legt der Export fur diese Daten eine neue XML- Datei 
an. Deswegen ist es vorteilhaft fur den Export der Alarme ei- 
ne neue Klasse anzulegen. Diese Klasse heilit CAlarmNavigati- 
on. Sie besitzt alle Eigenschaf ten, die eine „Navigation- 

20 Klasse* hat und ist wie folgt aufgebaut. 
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class CAlarmNavigation : 

public CBasisEsHelper , 
public CDomHelper 

{ 

public : 

//=======================^====== 3 ====== ! ==== s === s = a= ======================== 

//Const ruction/ Destruction 

CAlarmNavigation (_bstr_t bstrExportPath ) ; 
virtual -CAlarmNavigation {) ; 

// public methods 

//========-=========—-—=—-—====-================================ 

H RESULT ManageNavigation ( ) ; 

private : 

// private methods 

//=================================^^ 

HRESULT getTargetLanguage ( ) ; 

H RESULT getCurrentLanguage ( ) ; 

Quellcode 0.3. : Klassendefinition der Klasse CAlarmNavigation 

Der Einstiegspunkt fur den Export eines Projektes ist die 
Klasse CProj ectNavigation. Pro j ektglobale Daten werden, von 
dieser Klasse ausgehend, exportiert. Das heilit die Klasse CA- 
larmNavigation wird in der Klasse CProj ectNavigation angelegt 
und abgearbeitet . Dafur wird eine neue Funktion getAlarms in 
der Klasse CProj ectNavigation angelegt. Die Funktion Manage- 
Navigation der Klasse CProj ectNavigation mu!3 urn den Aufruf 
der Funktion getAlarms erweitert werden. 
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if ( <m_Export Filter & XM L DATA_ PROJECT EX T ) « XMLDATA_ PROJECT EXT ) { 

bx ~ gg&iU { ) - 

Quellcode 0.4. : Funktion ManageNavigation in der Klasse CProjektNavigation 

Die Funktion getAlarms der Klasse CProj ectNavigation erstellt 
einen Link zu der XML- Datei der Alarme . Er zeigt auf die 
XML- Datei, die spater die Alarme enthalt. Ober diesen Link 
ist es moglich vom Projekt auf die Alarme zuzugreifen, was 
fur den Import wichtig ist. Aufierdem muB die Funktion getA- 
larms eine Instanz der Klasse CAlarmNavigation anlegen und 
dessen ManageNavigation Funktion aufrufen. 
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H RESULT CProj ectNavigation : : getAlarms { ) 
{ 

HRESULT hr = S_OK; 

// Create Dom Node ProjecData 

DOM_Element domAlarms = m__domDoc . createEleraent ( "UMC_Alarms" ) ; 
m_domRoot Element . appendChild (domAlarms ) ; 

setXLink (domAlarms , _T ( "Alarms" ) , XLINK_FI LE ) ; 

Q ue j| code o.5. : Funktion getAlarms der Klasse CProjektNavigation ~" "~ " = 

Im Konstruktor der Klasse CAlarmNavigation wird eine neue 
XML- Datei angelegt, die Alarms .xml heiiit. Auflerdem wird die 
Membervariable m^bstrDataExportPath gesetzt, die den Pfad der 
Datei angibt. 

Nach dem Durchlaufen des Konstruktors durch das Anlegen einer 
Instanz der Klasse CAlarmNavigation wird nun die Funktion Ma- 
nageNavigation auf geruf en. 

Diese Funktion ilbernimmt die Organisation des Exports. Die 
Daten, der Alarme liegen im Basis ES . Es mufl also zuerst ein 
Pointer auf das Interface angefordert werden. Danach werden 
alle relevanten Daten mit Hilfe einzelner Funktionen aus dem 
Basis ES gelesen. 



Seite 42 von 56 



200023311 



43 



H RESULT CAlarmNavigation : : ManageNavigat ion ( ) 
{ 

HRESULT hr = SJDK; 

hr = getlnterf acePointer ( ) ; 

if (FAILED(hr) ) 
{ 

m_pExport->throw_Error ( get_ResSt ring ( I DS_EX_ERR_NAVALARMS ) ) ; 
return E_FAIL; 

} 

hr = openDomHelper (_T ( "Alarms" ) ) ; // root Node Name 

hr = .getVersion ( ) ; 
if ( FAILED { hr ) ) 

return E FAIL; 



hr = getCurrentLanguage ( ) ; 

if ( FAILED (hr) ) 

Quellcode 0.6. : Funktion Managed avigation der Klasse CAlarmNavigation 

Den Schnittstellenzeiger auf das Interface 

IMC_Alarm_S_Navigate erhalt man nur liber Umwege. Ausgehend 
vom Projekt wird ein Query In terface auf die Schnittstelle des 
Proj ektnavigators IMC_Proj ectNavigate gemacht - Der Zeiger auf 
diese Schnittstelle enthalt die globalen Objekte, die mit dem 
Aufruf der Funktion getObj ectBylD angesprochen wird. Hier ist 
es nun moglich ein Querylnterface auf das gewunschte Inter- 
face zu machen und dies einer Membervariable zuzuweisen. 
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HRESULT CAlarmNavigation: : getlnter facePointer ( ) 
{ 

// get a pointer to the interface of pro j ectnavigation 

CComQIPtr<IMC_ProjectNavigate, & IID_IMC_Pro j ectNavigate> pPN (m_pProj ect ) ; 

if (pPN « 0) 

return E_FAIL; 

IMC_Ident * pldent = NULL; 
DWORD ret = 0; 

// get a pointer to the interface of the global objects 
// form the pro j ectnavigation 

HRESULT hr = pPN->getObj ectBylD ( ESObj ectID_PmGlobCommon, Spldent, &ret ) ; 

i f ( { FAILED ( hr ) ) || (ret != BUMC_OK) > 
{ 

SafeRelease (pldent ) ; // freigeben 
return E FAIL; 



Quellcode 0.7. : Schnittstellenzeiger fDr die Alarme 



10 



15 



Wenn der Schnittstellenzeiger initialisiert ist, konnen die 
Daten aus dem Basis ES gelesen werden. Fur den Export der A- 
larme sind verschiedene Daten wichtig, wie die Version, die 
CurrentLanguage, die TargetLanguage, die NumberRange und die 
Alarmdaten an sich. 

Die Alarme gliedern sich in verschiedene Sprachen. Das heiflt 
zuerst xnuii man sich von der Schnittstelle die Liste der Alar- 
me (Funktion getAlarmsList) holen. Dann ist es moglich mit 
Hilfe der Daten eines Alarms (Funktion getAlarm) die ver- 
schiedenen Sprachen eines Alarms (Funktion getLanguageList) 
zu erhalten. Ausgehend von dem Alarm kann man jetzt den Text 
in der zugehorigen Sprache vom Interface erfragen (Funktion 
getAI arm Text) . Jede Funktion sollte die Daten, die sie erhal- 
ten hat, in das XML- File schreiben. 
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Der oberste Knoten heiftt Alarm und wird in der Funktion getA- 
larmsList gefiillt. 



m 



m 
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HRESULT CAlarmNavigation : : getAlarmsList ( ) 
{ 

HRESULT hr = S_OK; 

long size = 0; 

ESAlarmID * IDlist = NULL; 

// get the list of the alarmlDs 

hr = m_pIAlarm->GetAlarmIDList { &size, &IDlist ) ; 

if ( (FAILED(hr) ) II {IDlist == NULL) ) 
{ 

m_pExport-> 

throwjrror (get_ResSt ring ( IDS_EX_ERR_ALARM_LIST ) ) ; 
return E_FAIL; 

} 

// get the Alarm for each ID in the list 

fortint i = 0; i < size; i++) 

{ 

char string[256] « {0); 

// create a new element 

Quellcode 0.8. : Funktion getAlarmsList der Klasse CAlarmNavigation 

Wie man in diesem Ausschnitt sehen kann, wird das DOM_Element 
der getAlarm Funktion mit gegeben. Diese Funktion kann somit 
ein DOM_Element unter das iibergebene hangen. AuBerdem ruft 
die Funktion getAlarm die Funktion getLanguageList auf und 
ubergibt dieser das neue DOM_Element. 

Die Funktion getLanguageList hangt wiederum ein neues 
DOM_Element an das iibergebene. Somit wird DOM- Baum aufge- 
baut, dessen letztes Element der Alarmtext in einer bestimm- 
ten Sprache ist. 
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HRESULT CAlarmNavigation: : getAla rmText ( DOM_El ement * parentNode, ESAlarmLanguagelD Langua- 
ge ID, ESAlarmID dwAlarmID) 
{ 

HRESULT hr - S_OK; 

DWORD ret = 0; 

ComMCAlarmSTextData TextData; 

// get the text of the alarm 

hr = m_pIAlarm->GetRawText (dwAlarmID, LanguagelD, &TextData, &ret ) ; 

// connection to the interface was succseeded 

i f ( SUCCEEDED (hr ) ) 

{ 

// can't found the text of the alarm 

if {ret == BUMC_NOT_FOUND) 

{ 

wchar_t buffer [256) = {0}; 
char alarmstring [ 256] = {0}; 
char langstring ( 256] = {0}; 

_ultoa (dwAlarmID, alarmstring, 10) ; 

if {GetLocalelnfo {MAKELCID ( LanguagelD, SORT_DE FAULT ) , 

L OC A LE_S LANGUAGE, langstring, 255) — 0 ) 
strcpyt langstring, "") ; 

_snwprintf (buffer, sizeof (buffer) , 

get_ResString ( I DS_EX_WAR_ALARM_TEXT ) , 
m_szAlarmName, langstring ) ; 

m_pExport->throw_Error (buffer) ; 

return EFAIL; 

Quell code 0.9. : Funktion getAla rmText der Klasse CAlarmNavigation „ 



Seite 47 von 56 



200023311 



48 

Mit diesen Schritten ist es moglich alle Daten der Alarme ei 
nes Projektes zu exportieren. Urn die Datei im Internet Ex- 
plorer anzuzeigen, mufi jedoch eine DTD und ein XSL- .File vor 
handen sein. Fur die DTD existiert die Funktion wrdteDTD in 
der Klasse CDomHelper, die uberschrieben werden mufi. Urn den 
String der DTD zusammen zusetzten, kann man in der Datei 
DTDObjectDefs . h eine #define anfiigen. Die grundlegenden Defi 
nes sind in der Datei DTDHelper . h schon definiert. 
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///////////////////////////////////////////////////////////////////////////// 

// Ala rms 

// 

# define DTD_ALARMS \ 

\ 

DTD_D{ "Alarms" ) \ 

« DTD_E ( "Alarms ( Version, CurrentLanguage, TargetUnguage, IDRange? , " \ 

« "Alarm*)") \ 

« DTD_E( "Version (ft PCDATA)") \ 

« DTD_A{ "Version GUID CDATA # REQUIRED Major CDATA #IMPLIED " \ 

« "Minor CDATA #IMPLIED") \ 

« DTD_E( "CurrentLanguage (8 PCDATA)") \ 

« DTD_A{ "CurrentLanguage LanguagelD CDATA # REQUIRED " \ 

« "Name CDATA ^REQUIRED") \ 

« DTD_E("TargetLanguage (# PCDATA)") \ 

« DTD_A( "TargetLanguage LanguagelD CDATA # REQUIRED " \ 



QuelJcode 0.10.: DTD der AJarme 

Das XSL- File wird auch durch Defines erstellt. Diese Defines 
stehen in der Datei XSLDefs. h und basieren auf Defines der 
XSLDefsHelper.h Datei. 
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///////////////////////////////////////////////////////////////////////////////// 

// ALARMS XSL 
// 

ffdefine XSL_ALARMS 

XSL_ALARMS_ LANGUAGE 

« XSL_T( "Alarms", 

X S L_H TM L_ FON T ("Arial Black" , "3" , "Alarms" ) 

« " <TABLE STYLE=\"border:lpx solid black\">\n" 

« " <TR STYLE=\"font-size:12pt; font-family: Verdana; " 

« " font-weight : bold\">\n" 

« " <TD>Symbol</TD>\n" 

« " <TD STYLE=\ "background-color : 1 ightgrey\ ">Language</TD>\n" 

« " </TR>\n" 

« " <xsl: for-each select=\"Alarm\">\n" 

« " <xsl: for-each select=\"Alarmdata\">\n" 

« " <TR>\n" 

« " <TDXxsl:value-of select=\"esymbolname\"/X/TD>\n" 

« " <TD STYLE=\"background-color: lightgrey\ ">\n" 



\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 



Quellcode 0. 1 1.: XSL- Datei der Alarnie 



(w)Der Import 

(x) Der SAX- Parser 



Der SAX- Parser ist ein ereignisgesteuerter Parser, der beim 
Auftreffen auf ein XML- Tag in eine Funktion verzweigt. Es 
wird kein XML- Baum im Speicher gehalten, was der Performance 
10 zu Gute kommt. Durch diese Funktionalitat ist dieser Parser 
fiir den Import eines Projektes geeignet. 

Um den SAX- Parsers zu nutzen, sind die Headerdateien des 
Parsers im Projekt eingezogen. Der Parser besteht aus der 
Klasse HandlerBase und besitzt mehrere Funktionen, die von 
15 ihm bei bestimmten Ereignissen aufgerufen werden. Die Funkti- 
onen sind nur definiert und die endgtiltige Implementierung 
wird erst von dem Programmierer in einer abgeleiteten Klasse 
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durchgefuhrt . Damit kann man die Funktionen speziell auf das 
zu losende Problem zuschneiden. Weiterf uhrende Dokumentation 
dazu ist auf der Seite www . apache . de oder 
www.megginson . com/SAX/index . html zu f inden . 

5 

In der XML- Software ist die Klasse CSAXHandler von der Klas- 
se HandlerBase abgeleitet. Diese Klasse uberschreibt , wie aus 
dem Code ersichtlich, alle Funktionen der Klasse HandlerBase. 
Wichtig fur die Software sind davon allerdings nur die Funk- 
10 tionen startElement, endElement, characters und fur die Feh- 
lerausgabe die Funktionen warning, error und FatalError . 
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class CSAXHandler : public HandlerBase, public CImportBase 
{ 

public: 

bool ElementlsNormalTOType (_bstr_t bst rElementName ) ; 
bool ElementIsNormalTO(_bstr_t bst rEl ementName ) ; 
H RESULT GetResultO; 

void SetParseFile (_bstr_t bstrFile); 

bool GetDoValidation ( ) { return m_bDoValidation; } 

//Attributes 

static CParseManager * m_pParseManager ; 
static IsNameMapEntry * m_pTONameMap; 
static long m_lTONameMapSi ze; 

CSAXHandler ( ) ; 

CSAXHandler (_bstr_t bstrHandlerType ) ; 

CSAXHandler (_bstr_t bstrHandlerType, bool bDoValidation) ; 
virtual -CSAXHandler () ; 

protected: 

_bstr_t m_bstrParseFile; 
bool m_bErrorOccured; 
_bstr_t m__bstrHandlerType; 
bool m_bDoValidation; 

public : 

// 

// methods to be overwridden by the derived classes 

// 

virtual void HandleStartElement ( const XMLCh* const name, Att r ibuteListfi attributes); 
virtual void HandleEndElement ( const XMLCh* const name); 

virtual void HandleCharacters ( const XMLCh* const chars, const unsigned int length) ; 
____ ___ _ Q ue |i CO{ j e 0.12.: Klassendefiniu'on der Klasse CSAXHandler 
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Der Import beginnt in der Klasse CParseManager durch den Auf 
ruf der Funktion ParseProj ect . Hier werden einige Initiali- 
sierungen vorgenommen und der Import des gesamten Projektes 
wird angestoJien. 

Beim Parsen eines Startelementes ruft er SAX- Parser die 
Funktion startElement der Klasse CSAXHandler auf. Die Funkti 
on unterscheidet, ob das Tag ein Link oder ein normales Ele- 
ment ist. 



Seite 



53 



von 



56 



200023311 



54 

Wenn ein Link gefunden wird, stoftt die Funktion das Parsen 
der im Link enthaltenen Datei an. Um diese Funktionali tat bei 
alien Dateien mit Links zu gewahrleisten, wird fur jede XML- 
5 Datei eine sogenannte ^Handlerklasse^ erstellt, die von der 
Klasse CSAXHandler abgeleitet ist. 1st das gefundene Tag ein 
Link, wird ein Pointer auf die Handlerklasse initialisiert , 
die diese XML- Datei parsen soil. Danach wird das Parsen der 
Datei durch die Funktion ParseXLlnks der Klasse CParseManager 
10 angestofien. 

Beim Parsen von Elementen mufl man jedoch anders vorgehen. Da- 
fur stehen die Funktionen Handles tartElement, HandleEndEle- 
v merit und HandleCharacters zur Verfugung. Sie werden von den 

„Handlerklassen* entsprechend uberschreiben. Wenn die Funkti- 
15 onen startElement, endElement und characters mit einem Ele- 
ment aufgerufen wird, rufen sie die entsprechende der drei 
Funktionen HandleStartElement, HandleEndElement und Handle- 
Characters auf. 

2 0 (y) Handeln von Projektkomponenten 

Zum Importieren sollte eine „Handlerklasse* pro zu importie- 
render XML- Datei existieren. Diese Klassen sind von der 
Klasse CSAXHandler abgeleitet und erben somit die Funktiona- 
^?5 litat der Basisklasse. 

Wie beim Export kommt es beim Import auch auf den Inhalt der 
Dateien an. Bei einer Datei, die ausschliefilich Links ent- 
halt, wird die Funktion startElement der Basisklasse um IF- 
Abfragen erweitert. Wenn dagegen XML- Files mit Daten geparst 

30 werden sollen, kann man die Klassen wie folgt anlegen. 

Die Klassen miissen die Funktionen HandleStartElement, Hand- 
leEndElement und wenn notig HandleCharacters uberschreiben. 
Sie werden aufgerufen, wenn der Parser auf ein Start- oder 
Endelement bzw. auf einen Text getroffen ist. Dann ist es 

35 moglich in einer dieser Funktionen abzufragen, welches Tag 
der Parser gefunden hat. Somit kann dort eine Funktion zum 
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Auslesen der Daten aus dem gefundenen Element aufgerufen wer- 
den. Urn das Auslesen zu kapseln, sollten die Funktionen in 
einer sogenannten ^Makeklasse^ definiert werden. Die „Hand- 
lerklasse* besitzt als Membervariable einen Pointer auf die 
„Makeklasse* , die genau die Daten importiert , die das XML- 
File beinhaltet. Der Pointer wird im Konstruktor der „Hand- 
lerklasse* angelegt und im Destruktor freigegeben. Wenn ein 
Element gefunden wurde, das Daten fur den Import enthalt, 
dann wird in einer der drei oben genannten Funktionen eine 
Funktion der „Makeklasse* aufgerufen. 



class CAlarmHandler : public CSAXHandler 
{ 

public : 

//Const ruction/ Destruction 

//==========-=-=========-=----=-=====— ==-==-=========--=---^========== 

CAlarmHandler ( ) ; 

virtual -CAlarmHandler () ; 

// public methods 

Quellcode 0.13.: Beispiel fur eine „Handlerklasse" — . — . 

(z) Anlegen von Projektkomponenten mit „Makeklassen" 

Um die Daten zu importieren werden die Funktionen einer soge- 
nannten „Makeklasse* aufgerufen. Ein Beispiel fur eine solche 
^Makeklasse^ ist im Quellcode 0.17 vorhanden. 

Diese Klassen sind von der Klasse CBasisEsHelper abgeleitet. 
Damit sind alle Member und Funktionen der CBasisEsHelper 
Klasse der „Makeklasse* bekannt. Dies ist notwendig da die 
Daten in das Basis ES geschrieben werden mussen. Die Naviga- 
tion zu dem Pointer auf die Schnittstelle, die beim Schreiben 
der Daten angesprochen wird, ist im Kapitel (b) schon fur den 
Export erklart. Aufterdem befinden sich die Schnittstellen zum 
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Schreiben und Lesen meist an dem gleichen Interface. Desweg 
ist die Dokumentation iiber die 
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Navigation zu den gewunschten Interface nicht nochmals in 
diesem Kapitel enthalten. Der Pointer kann nun in einer Mem- 
bervariable gespeichert werden, da eine Instanz der „Ma- 
keklasse* wahrend des Parsens eines XML- Files im Speicher 
bestehen bleibt. 

Die „Makeklassen* benotigen nur Funktionen, die Daten eines 
Tags importieren. Es ist moglich Daten beim Auftreffen auf 
ein Element in das Basis ES zu schreiben oder beim Finden ei- 
nes Endtags. Dies ist wichtig, wenn Daten von Elementen, die 
darunter geschachtelt sind, zum Anlegen der Daten im Basis ES 
benotigt werden. 

Somit kann man fur jedes Starttag und Endtag eine eigene 
Funktion definiert werden, Darin werden die Daten der Elemen- 
te ausgelesen. Dabei gibt es mehrere Moglichkeiten, wie die 
Daten im Tag eingebunden sind. Wenn sich ein Element aus an- 
deren zusairimensetzt , dann sind die Daten in den darunterlie- 
genden enthalten. Jedes Tag kann naturlich auch eigene Daten 
besitzen, die in dessen Attributen gespeichert sind. Die ein- 
fachste und herkommlichste Art die Daten eines Elements zu 
speichern, ist jedoch im Text zwischen Start- und Endtag. 
Wenn die Daten aus dem Tag gelesen wurden, konnen sie mit 
Hilfe des Pointers auf die entsprechende Schnittstelle in das 
Basis ES geschrieben werden. Wenn dabei Fehler auftreten, 
sollte auch hier eine Fehlerausgabe erfolgen. 

(aa) Ein Beispiel fur den Import - importieren von Alarmen 

Wie beim Export soil auch an dieser Stelle ein Beispiel das 
in diesem Kapitel Beschriebene verdeutlichen . 

Der Import ist ereignisgesteuert und ruft bei einem Ereignis 
(Element) die Funktion startElement der Klasse CSAXHandler 
auf. Hier werden die Links ausgewertet. In diesem Beispiel 
ist das Ereignis „Link auf eine Datei Alarms. xml* wichtig, 
der das Auslesen dieser Datei anstoBt. 
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else if (bstrElementName — _bst r_t { U7 DXML_ALARMS ) ) 



Quellcode 0.14.: Importieren des Links auf die Datei Alarms, xml 

Die Variable pEventHandler der CSAXHandler Klasse wird mit 
einem Pointer auf die jeweilige „Handlerklasse* initiali- 
siert. In dem Fall der Alarme ist dies die Klasse CAlarmHand- 
ler. Wenn dieser Pointer initialisiert wurde, kann die Funk- 
tion ParseXlink der Klasse CParseManager aufgerufen werden, 
die dafur sorgt, dass das im Link enthaltene File geparst 
wird. 



if (pEventHandler) 
{ 

// parsing Xlink file with the created parse handler 
Quellcode 0. 15.: Starten des Parsens eines XML- File 

Wenn die Funktion startElement der Basisklasse CSAXHandler 
jetzt aufgerufen wird, verzweigt diese die Funktion Hand- 
leStartElements . Ebenso wird bei endElement der CSAXHandler 
die Methode HandleEndElements aufgerufen. Die Klasse CAlarm- 
Handler uberschreibt diese Funktionen, so dass dort eine 
spezielle Bearbeitung der XML- Datei umgesetzt werden kann. 
Durch den Pointer auf die „Makeklasse* CMakeAlarm kann auf 
Funktionen zugegriffen werden, die Alarme im Basis ES anle- 
gen. 
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void CAlarmHandler : : HandleStartElement (const XMLCh *const name, Att ributeList fiattributes) 
{ 

_bstr_t bstrElementName ( name ) ; 

if (bstrElementName. == _bstr_t ( U7DXML_CURRENT_LANGUAGE ) ) 
{ 

UMCINFO "HandleStartElement for: %s", ( cha r* ) bstrElementName END 
m_pMakeAlarm->setCurrentLanguage { name, attributes ) ; 

) 

else if (bstrElementName == _bstr_t (U7DXML_TRAGET_LANGUAGE ) ) 
{ 

UMCINFO "HandleStartElement for: %s", ( char* ) bstrElementName END 
m_pMakeAl a rm->setTarget Language (name, attributes ) ; 

} 

else if (bstrElementName == _bstr_t (U7DXML_IDRANGE) ) 
{ 

UMCINFO "HandleStartElement for: %s", ( char* ) bstrElementName END 
m_pMakeAlarm->setIDRange (name, attributes ) ; 

} 

else if (bstrElementName == _bstr_t ( U7DXML_ALARM ) ) 

Quellcode 0.16.: Auslesen der Anfangselemenle 

Den eigentlichen Import der Projektdaten ubernimmt die Klasse 
5 CMakeAlarm. Wenn ein Element im XML- File gefunden wurde, das 
Daten enthalt, die fur den Import wichtig sind, wird eine 
Funktion der Klasse CMakeAlarm aufgerufen, die diese Daten 
ins Basis ES schreibt. 



Seite 59 von 56 



200023311 



60 



class CMakeAlarm : public CBasisEsHelper 
{ 

public : 

//===================== ^ &&===========================================s== 

//Const ruction/ Destruction 

//===========================^======== =m 

CMakeAlarm{ ) ; 

virtual ~CMakeAlarm( ) ; 

// public methods 

void setAlarmText (const XMLCh *const name, Att ributeList &attributes ) ; 
void endAlarmText ( const XMLCh *const name); 

void setLanguage (const XMLCh * const name, Att ributeList ^attributes ) ; 
void endLanguage ( const XMLCh * const name); 

void setAlarmData ( const XMLCh * const name, AttributeList &attributes ) ; 
void endAlarmData (const XMLCh * const name); 

Quellcode 0. 17.: Importfunktionen filr Alarme ~~ . 

In den Methoden der Klasse CMakeAlarm werden die Daten aus 
den XML- Elementen gelesen und uber ein Interface in das Ba- 
sis ES geschrieben. Die Schnittstelle, die das Schreiben der 
Daten ermoglicht , heifit IMC_Alarm__S__Edlt und ist uber die 
selben Schnittstellen zu erreichen, wie die beim Export beno- 
tigte Schnittstelle. An diesem Interface werden dann die 
Funktionen zum Schreiben der Alarmdaten aufgerufen. 
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void CMakeAlarm: : setAlarmData { const XMLCh *corvst name, Att ributeList ^attributes) 
{ * 

HRESULT hr « S_OK; 

DWORD ret = 0; 

ComMCAl armS Data alarmdata; 
// get attributes 

_bstr_t bstrSymbolName = attributes . getValue ( "Symbolname" ) ; 
alarmdata . SymbolName « bstrSymbolName; 

_bstr_t bstrMsgType = att ributes . getValue ( "MsgType" ) ; 
alarmdata .MsgType - atoi { { cha r* ) bst rMsgType ) ; 

_bstr_t bstrMsgClass = attributes . getValue ( "MsgClass" ) ; 
alarmdata .MsgClass = atoi (( char* ) bstrMsgClass } ; 

_bstr_t bstrMsgText = attributes . getValue ( "MsgTextLocked" ) ; 
alarmdata . Msgtextlocked = atoi (( char* ) bstrMsgText ) ; 

_bstr_t bstrlnfoText = attributes . getValue (" Inf oTextLocked" ) ; 

Quellcode 0.18.: Schreiben von Daten in das Basis ES 
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Kommunikation mit Step7 

Die dritte und letzte Dll der Export- Import- Software, ist 
fur den Export und Import von den bei SIMOTION SCOUT enthal- 
tenen Step7- Anteilen zustandig. Die Hardwarekonf iguration 
eines Projektes kann mit der Exportf unktion von Step7 expor- 
tiert werden. Fur den Import steht ebenso eine Funktion von 
Step7 zur Verfiigung. Die Daten werden im ASCII- Format ge- 
speichert. Deswegen konnen die schon vorhandenen Funktionen 
von Step7 fur den XML- Export- Import verwendet werden. 
Die Schnittstelle, die dafur von Aufien angesprochen werden 
mufi, ist IXMLS7Project . Sie stellt die zwei Funktionen zum 
Export bzw. zum Import der Daten zur Verfiigung. Deswegen hei- 
fien diese Funktionen Import und Export. 



IUnknown m% 












DCMLS7Project (~*) 




:• 













Abbil dung 0.1.: Schnitlstellen des S7Servers 



Urn bei dem Export und dem Import nicht auf direkt auf das 
Step7 zuzugreifen zu mussen, ubernimmt ein sogenannter Daemon 
diese Aufgaben. Es werden Funktionen des Daemon aufgerufen, 
dieser „ubersetzt* die Aufrufe und fuhrt die entsprechenden 
Aktionen bei Step7 durch. 



Seite 62 von 56 



200023311 




Der Export sowie der Import der Step7- Projekte werden in der 
Klasse CXMLS7Proj ect durchgef uhrt . 

Fur den Export wird in dieser Klasse die Funktion Export auf- 
gerufen. Hier werden die Funktionen OpenProjectS7 , ChooseRe- 
levantStations, ExportRelevantStations und CloseProj ektsS7 
aufgerufen. Damit wird zuerst das zu exportierende Projekt 
und die darin enthaltenen Stationen ausgewahlt. Dann werden 
die Stationen durch ExportRelevantStations exportiert. Das 
Schliefien des Projektes wird mit Hilfe der Methode ClosePro- 
jektsS7 ermoglicht . 

Beim Importieren wird die Funktion Import aufgerufen. Das 
Offnen und Schliefien des Step7- Projektes ubernehmen auch 
hier die Funktionen OpenProj ectS7 und ClosePro- 
jektsS7. Weiterhin werden die Funktionen GetCurrentS7Handle, 
CompareStationNames und ImportOneStation verwendet. Die Me- 
thode CompareStationNames wird benotigt, um das Importieren 
einer schon im Projekt vorhandenen Station zu verhindern. 
Wenn Stationen importiert werden sollen, mufi die Methode Im- 
portOneStation fur die zu importierende Station aufgerufen 
werden. 
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Das Format und die Hierarchie der exportierten Daten 

Ein exportiertes SIMOTION SCOUT- Projekt wird in einer Ord- 
nerstruktur abgelegt. Diese Struktur ist angelehnt an den 
Aufbau eines Projektes im SIMOTION SCOUT- Proj ektnavigator . 




Abb il dung O.I.: Aufbau eines Projektes im Proj ektnavigator 



0 Die grofie Menge der Daten eines Projektes wird in geglieder- 
ten Datenblocken gespeichert. Damit wird eine tibersichtliche 
Datenhaltung inoglich gemacht, die dem Benutzer nach dem Ex- 
port immer noch logisch erscheint. Ein anderer Gesichtspunkt 
fur eine solche Hierarchie, ist die Moglichkeit, Komponenten 

5 eines Projektes zu analysieren oder uber das Internet zu ver- 
schicken, ohne das unwichtige Daten storen. 
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(bb) Die Hierarchie der exportierten Daten eines SIMOTION SCOUT- Projek- 
tes 

Ordner : MyProjectDataFolder 
Projekt .xml 
Ordner: Projekt 
Projekt . xml 
Alarms . xml 
Installation . xml 
Ref erenceTable . xml 
S7Pro j ectData . xml 
Ordner: Device 
Device .xml 
RunTimeLevels . xml 
DeviceData . xml 
Device_Symbols .xml 
Ordner : ProcessingUnit 
ProcessingUnit . xml 
SCL-Programm. xml 
Ordner: TOCamType 
TOCamType .xml 
Kurvenscheibe . xml 
Ordner: TOPosAxis 
TOPosAxis .xml 

Ordner : Positionierungsachse 
Positionierungsachse . xml 
ExpertList .xml 

3 0 (cc) Erlauterung zu den exportierten Dateien 

In der Hierarchie werden unterschiedliche XML- Dateien ange- 
legt. Dateien konnen ausschlieiilich Links enthalten oder aus- 
schliefllich Daten. Die Dateien, die Links enthalten, liegen 
35 in einem gleichnamigen Ordner und sind die Dateien, durch die 
der Einstieg in diesen Ordner ermoglicht wird. Die Links, die 
in den Dateien enthalten sind, verweisen auf XML- Dateien, 
die fur die Datenhaltung zustandig sind und im gleichen Ord- 
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ner liegen. AuJJerdem konnen die Links auch auf die Einstiegs- 
dateien der Unterordner zeigen. Durch dieses Prinzip wird die 
Portierbarkeit vereinfacht. Das heiftt es ist gewahrleistet, 
einen Ordner aus der Hierarchie zu nehmen, ohne das die 
5 Struktur verloren geht . Somit konnen relevante Daten an Drit- 
te weiter gegeben werden ohne unnutze Dateien mit zuliefern. 



Ordner : MyPro j ectDataFolder - Der Ordner enthalt das ge- 
samte exportierte Projekt mit alien XML- 
10 Dokumenten, XSL- Dateien, HTML- Sei- 

ten und gegebenenf alls Unterordnern, 
^ die alle Daten des Projektes mit 

dessen speziellen Eigenschaf ten im 
XML- Format beschreiben. Der Name 
15 dieses Ordners wird durch den Benut- 

zer gewahlt (siehe Kapitel (g) ) 
Zu diesem Ordner existiert eine XML- 
Datei, die das Projekt im ganzen 
verlinkt und die in diesem Fall Pro- 
20 jekt.xml heifit. 

Projekt. xml - Diese Datei beinhaltet alle 

Links zu den XML- Dateien, welche die 

Projektdaten genauer spezif izieren, 
JjQf> wie zu Beispiel die einzelnen Devi- 

ces des Projektes. 
Ordner: Projekt - Durch diesen Ordner werden 

die projektglobalen Daten gekapselt. 

30 Projekt. xml - Diese „Linkdatei* verweist auf 

die Devices und alle XML- Datei, 

die projektglobale Daten enthalten. 
Alarms. xml - Zum Speichern der Alarmdaten 

eines SIMOTION SCOUT- 
35 Projektes ist diese Datei entstan- 

den . 
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Installation. xml - In dieser Datei sind Kom 

ponenten von SIMOTION SCOUT 

beschrieben, die beim Zeitpunkt de 
Exports installiert waren. 
Ref erenceTable . xml - Diese Datei enthalt alle Refe 

renzen und Verweise, die einzelne 
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S7Pro jectData .xml 



10 Ordner: Device 



15 



20 



Teilkomponenten untereinander besit- 
zen. Damit nach dem Import die Funk- 
tionalitat der Objekte wieder vor- 
handen ist, wird diese Datei ausge- 
wertet. 

Die Hardwarekonf iguration der Step7- 
Anteile wird in der 

Datei beschrieben . 

In diesem Ordner sind alle XML- Do- 
kumente, XSL- Files, HTML- 

Seiten und Unterordner enthalten, 
die Einzelheiten eines Device bein- 
halten. Da ein Projekt aus mehren 
Devices aufgebaut sein kann, das.s 
mehrere Ordner dieser Art vorhanden 
sind. 

Auch in diesem Ordner wurde eine 
XML- Datei erstellt, die dieses De- 
vice im XML- Format beschreibt. 



30 



35 



Device. xml - Wie oben erklart, verwaltet diese 

Datei Links zu anderen 

untergeordneten XML- Dateien. 
RunTimeLevels .xml - In der Datei stehen 

die Tasks, die von dieser Device bearbeitet 

werden konnen. 

DeviceData.xml - Diese Datei beinhaltet die Ei- 

genschaften eines Device. 

Devi ce_Symbols .xml - Hier werden die Symbole und Va- 

riablen eines Device gespeichert, 
wie z.B. 10- Variablen. 
Ordner : ProcessinqUnit - Dieser Ordner enthalt alle 

Programme, die in die CPU geladen 

werden konnen und ausgefuhrt werden 
konnen . 
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ProcessingUnit . xml - Diese Datei enthalt alle Links 

auf die erstellten Programme. 

SCL-Programm.xml - In dieser Datei wird ein Pro- 

gramm (MCC- Programm oder St- 
5 Programm) beschrieben. 

Ordner: TOCamType - Der Ordner enthalt fur die Kur- 

venscheiben spezifische Daten. 

TOCamType. xml - Alle Links auf die im Projekt ent- 

haltenen Kurvenscheiben sind in 

dieser Datei enthalten. 
Kurvenscheibe . xml - Hier werden die Daten einer 

Kurvenscheibe gespeichert . 

Ordner : TQPosAxis - Dieser Order enthalt alle Daten 

der Positionierungsachsen. Alle 

anderen Objekte, die in einer Stati- 
on enthalten sein konnen, werden in 
einer ahnlichen Hierarchie hinter- 
legt, dabei macht eine Kurvenscheibe 
eine Ausnahme . So werden zum Bei- 
spiel alle Messtaster einer Station 
in einem Ordner namens „TOMeasurin- 
glnputType* gespeichert. Dieser Ord- 
ner beinhaltet eine gleichnamige 
XML- Datei die Links zu jeder XML- 
Datei eines einzelnen Messtasters. 
Diese XML- Files tragen den Namen 
des Messtasters und liegen in einem 
gleichnamigen Unterordner des „TO- 
MeasuringlnputType* - Ordners. In 
diesem Ordner ist aufierdem die Ex- 
pertenliste des Messtasters im XML- 
Format gespeichert . 

TOPosAxis .xml - Die Datei bein- 

haltet Links zu den einzelnen Positionierungsachsen 



10 



15 



20 



30 



35 
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Ordner : Positionierungsachse - Dieser Ordner enthalt 

alle Daten einer Positionierungsachse 

Positionierungsachse . xml - Diese ^Linkdatei^ zeigt 

auf die „Datendatei* der Positionierachse . 

ExpertList .xml - Die Expertenliste der Positio- 

nierungsachse ist in der Datei 

hinterlegt . 
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Patentansprliche 

1. Verfahren zur Ablage und zur Bearbeitung von Projekt- 
und/oder Pro j ektierungsdaten einer Automat i si erungskompo- 
nente, 

gekennzeichnet durch eine Untermenge folgender Merkmale: 

Bereitstellung von Projektdaten einer Automatisierungskom- 
ponente auf Basis XML, 

Export/ Import von Projektdaten in XML und 
Verarbeitung der XML-Daten mit Standardwerkzeugen . 

2. Verfahren nach Anspruch 1, 

dadurch gekennzeichnet, dass als Standardwerzeuge eine Unter- 
menge von 

Ver s ions verwaltungs tools 

Externe CAD-Programme 

Externe Kurvenscheibenwerkzeuge 

Externe Productivity Tools 

Externe Skripting Mechanismen 
verwendet wird. 

3. System zur Ablage und zur Bearbeitung von Projekt- 
und/oder Proj ektierungsdaten einer Automatisierungskompo- 
nente, 

gekennzeichnet durch eine Untermenge folgender Merkmale: 

- Bereitstellung von Projektdaten einer Automatisierungskom- 
ponente auf Basis XML, 

- Export/ Import von Projektdaten in XML und 

- Verarbeitung der XML-Daten mit Standardwerkzeugen. 

4. System nach Anspruch 3, 

dadurch gekennzeichnet, dass als Standardwerzeuge eine Unter- 
menge von 

Vers ions verwaltungs too Is 

- Externe CAD-Programme 
Externe Kurvenscheibenwerkzeuge 

- Externe Productivity Tools 
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Externe Skripting Mechanismen 
verwendet wird. 
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